home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / scsicontrol.z / scsicontrol
Encoding:
Text File  |  1998-10-20  |  8.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))                                                ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsicontrol - probe and control scsi devices
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ssssbbbbiiiinnnn////ssssccccssssiiiiccccoooonnnnttttrrrroooollll [[[[----CCCCDDDDHHHHIIIISSSSaaaaccccddddeeeeggggiiiillllmmmmqqqqssssvvvv]]]] [[[[----bbbb bbbblllloooocccckkkkiiiizzzzeeee]]]] _d_e_v_i_c_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_c_s_i_c_o_n_t_r_o_l may be used to print info from the SCSI inquiry commands,
  16.      which normally indicate the device type, manufacturer, and similar info.
  17.      Other options may be used show more data, or to issue commands that
  18.      control the operation of the device, or the bus as a whole.  By using the
  19.      debug option (----dddd), the exact command sent, and the data returned (if any)
  20.      is displayed, along with more extensive error information.
  21.  
  22.      The device(s) may be specified without the normal /_d_e_v/_s_c_s_i prefix, if
  23.      desired.
  24.  
  25.      ----CCCC   Send the SGI-specific command that causes the CD-ROM drive to reply
  26.           to the inquiry command (see ----iiii below) as a CD-ROM drive.  On
  27.           poweron, or after a SCSI bus reset (either as part of error recovery
  28.           or from a user issued command), the CD-ROM drives sold by SGI
  29.           respond to inquiry as a hard disk.  This was done because older
  30.           systems would otherwise refuse to boot from the CD-ROM drive.
  31.  
  32.      ----DDDD   Send the SCSI self test (diagnostic) command to the device.
  33.  
  34.      ----HHHH   Send the SCSI halt, or stop, command.  This causes the device to
  35.           stop the media, or in some cases, to unload it.
  36.  
  37.      ----SSSS   Send the SCSI start, or load, command.  This causes the device to
  38.           start the media, or in some cases, to load it.
  39.  
  40.      ----aaaa   Attempt to negotiate with the device to operate in asynchronous
  41.           mode.  This will usually mean a lower data rate on the SCSI bus, but
  42.           is less sensitive to scsi cabling problems, etc.  Some devices will
  43.           negotiate synchronous mode, but may not work correctly in that mode.
  44.           This can also be forced by changing the configuration variables for
  45.           the scsi controller driver (e.g., the _w_d_9_3__s_y_n_c_e_n_a_b_l_e array in the
  46.           file /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_w_d_9_3).  Also see the ----ssss option below.
  47.  
  48.      ----dddd   Debug mode.  This causes all commands sent to the device and  the
  49.           data that is returned, if any, to be printed.  Extensive information
  50.           about errors is also printed when they occur.
  51.  
  52.      ----eeee   Open the device in exclusive mode.  This will fail (with busy
  53.           status) if the device is in use by some other process or SCSI
  54.           driver.  If it succeeds, other opens will then fail.  This mode
  55.           applies to the host controller driver, and does not issue any SCSI
  56.           commands to the device (in particular, the reserve unit command is
  57.           not sent).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))                                                ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      ----gggg   Get the host adapter flags for this SCSI bus.  This is mostly of
  75.           interest to driver writer's, but it does provide a way to determine
  76.           if the SCSI disconnect option has been disabled on the bus.
  77.  
  78.      ----iiii   Send the SCSI inquiry command, and display the info in a readable
  79.           fashion.  The information typically includes the device type, the
  80.           manufacturer, the SCSI version, and some of the optional SCSI
  81.           features the device supports.  Also see ----IIII below.
  82.  
  83.      ----IIII   display all the data from the ----iiii or ----vvvv options in both hex and ascii
  84.           form.  Implies ----iiii if neither ----iiii or ----vvvv were given on the command
  85.           line.
  86.  
  87.      ----qqqq   Quiet mode.  Don't print the name of each device as it is opened,
  88.           unless an error occurs.
  89.  
  90.      ----ssss   Attempt to negotiate with the device to operate in synchronous mode.
  91.           This is normally done by the operating system when the device is
  92.           first used, but that may fail, and the system will not then re-
  93.           attempt to negotiate.  Some drivers will suppress the negotiation.
  94.           Operating in synchronous mode will usually mean a higher data rate
  95.           on the SCSI bus, but this mode is more sensitive to SCSI cabling
  96.           problems.  Additionally, some devices will negotiate successfully
  97.           for this mode, but will not work correctly.  Also see the ----aaaa option
  98.           above.
  99.  
  100.      ----vvvv   Issue the SCSI iiiinnnnqqqquuuuiiiirrrryyyy command with the vital products modifier, and
  101.           display the data in a readable fashion.  The vital product data
  102.           often includes the serial number, and the additional information
  103.           about the device.  Also see ----IIII above.
  104.  
  105.      ----cccc bbbblllloooocccckkkkssssiiiizzzzeeee
  106.           For devices that support the readcapacity command, print the
  107.           capacity of the device, and if it's block oriented, the number of
  108.           bytes per block.
  109.  
  110.      ----bbbb bbbblllloooocccckkkkssssiiiizzzzeeee
  111.           Set the blocksize (for disks, CDROMs, and some types of tape drives)
  112.           to the given value, and also report the previous value.  bbbblllloooocccckkkkssssiiiizzzzeeee
  113.           may be given in decimal, hex (with leading 0x), or octal (with
  114.           leading 0).  Not all devices support changing their block size.
  115.  
  116.      ----llll   Print the current values of all the supported logsense pages.  This
  117.           can sometimes be useful in debugging device problems, but almost
  118.           always requires the device specific manual from it's manufacturer,
  119.           to be of use.
  120.  
  121.      ----mmmm   Print the current values of all the supported modesense pages.
  122.           Mostly of use to people debugging problems or writing devscsi
  123.           drivers.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))                                                ssssccccssssiiiiccccoooonnnnttttrrrroooollll((((1111mmmm))))
  137.  
  138.  
  139.  
  140. FFFFIIIILLLLEEEESSSS
  141.      /dev/scsi/sc* - the generic scsi driver devices /dev/scsi/jag* - the
  142.      generic scsi driver devices
  143.  
  144. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  145.      dsopen(3X), ds(7M), scsiha(1M), scsiha(7M).
  146.  
  147. NNNNOOOOTTTTEEEE
  148.      This command is normally usable only by the superuser, because the
  149.      standard permissions of the devices in /dev/scsi restrict access to other
  150.      users.
  151.  
  152.      The source to this program is also shipped as sample source code in the
  153.      iiiirrrriiiixxxx____ddddeeeevvvv....ggggiiiiffffttttssss....ssssccccssssiiii subsystem as part of _IIII_DDDD_OOOO.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.